home *** CD-ROM | disk | FTP | other *** search
/ SuperHack / SuperHack CD.bin / CODING / SOUND / AWEMP150.ZIP / AWEMP.DOC next >
Encoding:
Text File  |  1996-08-11  |  16.1 KB  |  374 lines
  1. ╓─────────────────────────────────────────────────────────────────────────────╖
  2. ║  Sound Blaster AWE32 Module Player v1.50           (c) 1995,1996 Bert Boer  ║
  3. ║  Documentation                                         All rights reserved  ║
  4. ╙─────────────────────────────────────────────────────────────────────────────╜
  5.  
  6. ╓────────────────╖
  7. ║  1. Contents.  ║
  8. ╙────────────────╨─────────────────────────────────────────────────────────────
  9.  
  10.      2. Welcome to AWEMP/32!
  11.      3. Disclaimer.
  12.      4. Distribution rules.
  13.      5. Files in this package.
  14.      6. Commandline options.
  15.      7. Overview.
  16.      8. The main screen.
  17.      9. The file selector.
  18.     10. Sample 'n instrument info.
  19.     11. Future plans.
  20.     12. Greetings!
  21.     13. Contacting the author.
  22.  
  23. ╓───────────────────────────╖
  24. ║  2. Welcome to AWEMP/32!  ║
  25. ╙───────────────────────────╨──────────────────────────────────────────────────
  26.  
  27.     Welcome to AWEMP/32! You've probably waited a rather long time for a
  28.     new release since the v1.45 release. I've been able to add dozens of
  29.     names to my ever growing supporters list, big thanks guys! There were
  30.     also people who thought AWEMP was dead, well.. they were wrong. Here is
  31.     a brand new release of the ultimate module player for the Sound Blaster
  32.     32 (PnP) and Sound Blaster AWE32 (PnP) soundcards!
  33.  
  34. ╓──────────────────╖
  35. ║  3. Disclaimer.  ║
  36. ╙──────────────────╨───────────────────────────────────────────────────────────
  37.  
  38.     I wonder if it's ever possible to do harm to anyone (a computer?) with
  39.     this program, but who knows, so here it goes:
  40.     "The author (=me) cannot be held liable for damage and/or loss of data
  41.     caused by use of this program, nor for possible deafness or blown
  42.     speakers caused by the volume being turned up too high."
  43.     Hope this is clear enough . . .
  44.  
  45. ╓──────────────────────────╖
  46. ║  4. Distribution rules.  ║
  47. ╙──────────────────────────╨───────────────────────────────────────────────────
  48.  
  49.     This program is released as freeware! That means no one has to pay a
  50.     penny for use of this program. Distribution of AWEMP on CD-ROMs,
  51.     PD-disks, etc is only allowed with permission of the author. Contact
  52.     address can be found at the end of this documentation file. If you
  53.     put this on a CD-ROM I would like to receive a copy (if possible).
  54.  
  55.     I encourage everyone to distribute this program as much as possible!
  56.     Place it on your local BBS, upload it to ftp-sites or put it on your
  57.     www-site, just make sure everyone can make use of this great player.
  58.  
  59.     Although I like to receive postcards (by means of cardware), you're
  60.     not obliged to sent me one. As was with previous releases of AWEMP,
  61.     everyone who sends me a postcard, snail-mail or just e-mail will be
  62.     mentioned in the "unofficial" supporters list.
  63.  
  64. ╓─────────────────────────────╖
  65. ║  5. Files in this package.  ║
  66. ╙─────────────────────────────╨────────────────────────────────────────────────
  67.  
  68.     A lot of files in the AWEMP/32 v1.50 package this time. Main files are
  69.     the AWEMP and DOS4GW executables. Here's a list of the files in this
  70.     package with a short description:
  71.  
  72.       AWEMP.EXE       Main executable.
  73.       DOS4GW.EXE      Protected mode memory manager used by AWEMP/32.
  74.  
  75.       IMPORTFX.EXE    Additional program to add new FX algorithms.
  76.       AWEMP.FX        Database containing the FX algorithms.
  77.  
  78.       AWEMP.INI       Preferences file.
  79.       AWEMP.PIF       File used by Windows 3.1/3.11 and Windows 95.
  80.  
  81.       AWEMP.DOC       The file you're reading at the moment.
  82.       AWEMP.Q&A       Commonly asked questions and their answers.
  83.       AWEMP.REV       Revision history of the AWEMP project.
  84.  
  85.       FEATURES.TXT    AWEMP/32 v1.50 features.....
  86.  
  87.       DISTSITE.LST    List of all distribution sites.
  88.       SUPPORT.ERS     Comprehensive list of names of loyal AWEMP users.
  89.  
  90.       FREEDOM.LST     Sample playlist file.
  91.  
  92.       EMUPROG.TXT     Info about available programming info of the EMU8000.
  93.  
  94.     Check out AWEMP.Q&A if you're having problems running AWEMP. If you
  95.     want to know what AWEMP features, see the file FEATURES.TXT.
  96.     When you send me some feedback you can expect to see your name in
  97.     the file SUPPORT.ERS. Etc, etc.....
  98.  
  99. ╓───────────────────────────╖
  100. ║  6. Commandline options.  ║
  101. ╙───────────────────────────╨──────────────────────────────────────────────────
  102.  
  103.     Note that not a single commandline option has to be passed to AWEMP.
  104.     There are default values for each setting which can be edited in the
  105.     preferences file (AWEMP.INI) or within the player.
  106.  
  107.     When there's no module or playlist file specified at the commandline,
  108.     AWEMP starts up with the file selector. Here you can pick a file you
  109.     wish to play (see section 9: the file selector).
  110.  
  111.     All commandline options listed below override the default values!
  112.     Valid values are mentioned between brackes [/].
  113.  
  114.       /A[-]   Advanced Memory Management System (tm).
  115.       /Cxxx   Chorus level [0-256]
  116.       /ECxxx  Chorus FX ## in effect list
  117.       /ERxxx  Reverb FX ## in effect list
  118.       /H      Help on commandline options and general usage
  119.       /Lx[-]  Repeat mode [0-2, 0: no repeat, 1: repeat, 2: repeat plst]
  120.       /M[-]   Mono playback
  121.       /O[-]   Shuffle playlist (random)
  122.       /Rxxx   Reverb level [0-256]
  123.       /Uxxx   EMU8000 subsystem baseport [620-680]
  124.       /X[-]   Exit player at end-of-playlist
  125.  
  126.     Options may also be preceded with a '-' instead of the slash character.
  127.     The '-' character after an options disables that setting.
  128.  
  129. ╓────────────────╖
  130. ║  7. Overview.  ║
  131. ╙────────────────╨─────────────────────────────────────────────────────────────
  132.  
  133.     At first sight you will notice some changes in the screen layout. First
  134.     there's the 80x50 mode, second is window bordering and the pseudo-3d
  135.     buttons. I decided to throw away the old layout and draw a new one,
  136.     however some people didn't like my draft, so I took the old interface
  137.     again and improved it. I hope you all like it.
  138.  
  139.     AWEMP/32 v1.50 has become a stand-alone application. You can now select
  140.     modules from the file selector, move them to the play-list or create a
  141.     new playlist from scratch. Everything can be configured the way you
  142.     want it. All major module formats are supported, including the new IT
  143.     format! Windows 3.1 and Windows 95 users now finally have continuously
  144.     playback, even in the background.
  145.  
  146. ╓───────────────────────╖
  147. ║  8. The main screen.  ║
  148. ╙───────────────────────╨──────────────────────────────────────────────────────
  149.  
  150.     Following keys are available in every screen (not just the main
  151.     screen):
  152.  
  153.       ESC        The forbidden key :) Normally, with this key you can
  154.                  close all opened windows, however when there are no
  155.                  opened windows the player stops and exits to DOS.
  156.  
  157.       ENTER,N/B  With the N+B keys you can play the next cq. previous
  158.                  module in the playlist. The ENTER key has the same
  159.                  function as the N key. If the playlist is empty
  160.                  you'll go to the file selector immediately.
  161.  
  162.       F4,A       Sample 'n instrument info. Instrument info is only
  163.                  available in XMs and ITs.
  164.  
  165.       C          Pop up the preferences window, here you can change
  166.                  several options concerning module playback and
  167.                  playlist control.
  168.  
  169.       D          You like DOS? Then this is the key for you.... Btw,
  170.                  playing will not stop (what a pity, isn't it? :)
  171.                  You're tired of DOS? Then type EXIT at the prompt
  172.                  and you'll be back in the player within notime.
  173.  
  174.       E          Enter the magic FX selector. Here you can select and
  175.                  try out reverb and chorus effects to your liking.
  176.  
  177.       F          Walk in the file selector right away. You're probably
  178.                  already familiar with file selectors like this one
  179.                  so I'm not goin' to tell you how to use it.... :)
  180.  
  181.       G          Uhm.. this key does nothing, no really.
  182.  
  183.       F1,H       "What was that ESC key good for?" When you ask yourself
  184.                  questions like this one, it is the right time to press
  185.                  the F1 or H key.
  186.  
  187.       L          Enter the playlist. You can create and edit the
  188.                  playlist in the file selector window.
  189.  
  190.       O          Toggle stereo/mono playback. Very handy when you're
  191.                  listening to MODs with headphones put on.
  192.  
  193.       P          Pause/unpause song playing. Current playing status
  194.                  is shown in the second window from top, ie. the
  195.                  symbols you'll often find on CD players.
  196.  
  197.       Q          You want more bass? Then this key will pop up the
  198.                  equalizer control, here you can change the overall
  199.                  sound the way you want it....
  200.  
  201.       T          Toggle elapsed/remaining time display. The remaining
  202.                  timer can display wrong times, this is due to the
  203.                  way I calculate it, ie. the time is affected by the
  204.                  speed and bpm values.
  205.  
  206.       F5-F8      User defined keys. Default the keys are defined as
  207.                  follows: F5+F6 = [+] and F7+F8 = {+}, ie. with
  208.                  F5+F6 you can control the reverb level and with
  209.                  F7+F8 the chorus level.
  210.  
  211.       CTRL-F2    Save current settings. Yes, it saves everything that
  212.                  can be adjusted in the current window. Btw, settings
  213.                  are saved to the file AWEMP.INI.
  214.  
  215.       [/]+{/}    Adjust reverb or chorus level. Current levels are
  216.                  shown in the second window from bottom.
  217.  
  218.       -/+        Adjust global volume. This does not affect the MIDI
  219.                  volume anymore (as it did in previous versions).
  220.                  Current global volume is shown in the second window
  221.                  from top.
  222.  
  223.     Following keys are only available in a shell-to-DOS session:
  224.  
  225.       F11        Pause/unpause playing, also resets playing speed if
  226.                  it was changed by some program.
  227.  
  228.       F12        Stop playing, resets song playing position to 0.
  229.  
  230.       SHIFT-F11  Decrease/increase global volume.
  231.       SHIFT-F12
  232.  
  233.       CTRL-F11   Decrease/increase song playing position.
  234.       CTRL-F12
  235.  
  236.     Following keys are only available in the main screen:
  237.  
  238.       1-0,M      Mute/unmute channel. Keys 1-0 refer to channels 1 to 10.
  239.  
  240.       S          Solo/unsolo channel, quite obvious meaning I would say
  241.                  so.
  242.  
  243.       /        Decrease/increase song playing position.
  244.  
  245.       CTRL-/   Decrease/increase beats per minute rate. Btw, the bpm
  246.                  rate can be locked in the preferences window.
  247.  
  248.       CTRL-/   Decrease/increase speed rate.
  249.  
  250. ╓─────────────────────────╖
  251. ║  9. The file selector.  ║
  252. ╙─────────────────────────╨────────────────────────────────────────────────────
  253.  
  254.     Keys available in the file selector:
  255.  
  256.       TAB        Switches from the file selector on the left to
  257.                  the playlist on the right (of the screen).
  258.  
  259.       F2         Reread directory or archive. Good thing to do when
  260.                  the directory structure has been changed while you
  261.                  were in a OS-shell session.
  262.  
  263.       ALT-S      Toggle sort files on/off. When this option is turned
  264.                  on files will be sorted on alphabetical order.
  265.  
  266.       ALT-Q,F9   Toggle quick scan on/off. Quick scan means that the
  267.                  files will not be scanned internally for titles,
  268.                  number of channels and file sizes.
  269.  
  270.       ALT-A      Toggle show all files on/off. With this option turned
  271.                  on all files will be shown instead of the files with
  272.                  extensions defined in AWEMP.INI.
  273.  
  274.       ALT-I      Toggle quick search feature on/off. With this option
  275.                  turned on you can search for modules very quicky:
  276.                  just type the first two or three characters of a
  277.                  filename and the file selector automatically searches
  278.                  for the closest match.
  279.  
  280.       INS/DEL    Insert or delete a file to/from the playlist. The
  281.       /        playlist is shown on the very right of the screen btw.
  282.  
  283.       CTRL-/   Move a playlist entry up/down in the playlist.
  284.                  Available only when you're in the playlist editor!
  285.  
  286.       CTRL-/   Add all files from the file selector to the playlist
  287.                  or remove all entries from the playlist.
  288.  
  289. ╓──────────────────────────────────╖
  290. ║  10. Sample 'n instrument info.  ║
  291. ╙──────────────────────────────────╨───────────────────────────────────────────
  292.  
  293.     Keys available in the sample and instrument info window:
  294.  
  295.       TAB        Switch between sample/instrument info. Instrument info
  296.                  is only available in XMs and ITs.
  297.  
  298.       ...        No more special keys here, sorry.
  299.  
  300.     As in the file selector all common keys are ofcourse available too.
  301.  
  302. ╓─────────────────────╖
  303. ║  11. Future plans.  ║
  304. ╙─────────────────────╨────────────────────────────────────────────────────────
  305.  
  306.     Well.. what's in store for you? Here are a few things you can expect
  307.     in future releases of AWEMP/32:
  308.  
  309.       ■ Emu8000 control center, allows you to manually adjust registers
  310.         and gives you control of all hardware lfo's, envelopes and the
  311.         digital equalizer.
  312.       ■ Integrated FX editor, no separate programs like IMPORTFX.EXE.
  313.       ■ Maybe a seperate version for Windows 3.1 and Windows 95 users,
  314.         with a delicious graphical interface :)
  315.  
  316.     If you do happen to have a truly brilliant idea of something which
  317.     should be in the next release of AWEMP/32, don't hesitate to share
  318.     it with me!
  319.  
  320. ╓──────────────────╖
  321. ║  12. Greetings!  ║
  322. ╙──────────────────╨───────────────────────────────────────────────────────────
  323.  
  324.     Greetings and thanks must go to the following persons:
  325.  
  326.       ■ Klaasjan Brand aka Gemini: Okay, okay, now you own a P166, so
  327.                                    what? :)
  328.       ■ Gerard Veldman aka Morgue: Great guy who helped me out with oh
  329.                                    so many coding troubles (darn I just
  330.                                    hate that 'page fault' error! :)
  331.       ■ Cedric Amand aka MrGun   : If you ever want a mixer prog which
  332.                                    works fast, more accurate than SB16SET
  333.                                    and does not generate clicks than
  334.                                    MasterMixer is THE mixer for you!
  335.                                    (hey Cedric, what about this ad? :)
  336.       ■ Jari Halonen aka Galahad : Now you can play your beautifully made
  337.                                    ITs with your favorite player :)
  338.       ■ Vince Vu aka Judge Dredd : Thanks for helping me out with those
  339.                                    EMU8000 coding hassles.
  340.       ■ Jeffrey Lim aka Pulse    : I guess NNA is THE invention in tracker
  341.                                    world since years! :)
  342.       ■ Bert Boer aka Trigon     : Hmm.. greeting yourself is a bit unusual
  343.                                    I think.
  344.  
  345. ╓──────────────────────────────╖
  346. ║  13. Contacting the author.  ║
  347. ╙──────────────────────────────╨───────────────────────────────────────────────
  348.  
  349.     First a little about myself: name Bert Boer, handle Trigon, 18 years,
  350.     1.85m, about to study computational science, owning a decent P120
  351.     machine, driving a metallic blue porsche sportscar, looking for nice
  352.     girlfriend, startrek and starwars fan, etc, etc...
  353.  
  354.     If you want to contact me for any reason, mail me at one of the
  355.     following addresses:
  356.  
  357.       ■ Mail address: Bert Boer
  358.                       Schapendrift 30
  359.                       8091 GW Wezep
  360.                       The Netherlands
  361.  
  362.       ■ Internet    : b.boer@net.hcc.nl  (preferred)
  363.                       trigon@ddu.iwg.nl
  364.  
  365.       ■ Netmail     : 15:1100/400.6
  366.  
  367.       ■ Fidonet     : 2:282/116
  368.  
  369.     Please have some patience waiting for reply on snail-mail. I will try
  370.     to answer everyone, but sometimes there are more important things in
  371.     life you know...
  372.  
  373. ───────────────────────────────────────────────────────────────────────────────
  374.